-*-Text-*-
###################################################################
 FILE: "JEG Image Tools Readme"
                                   created: 3/13/97 {2:29:16 PM} 
                               last update: 8/2/98 {6:12:18 PM} 
 Author: Jonathan Guyer
 E-mail: <jguyer@his.com>
    www: <http://www.his.com/~jguyer/>
		 
 Note: Many of these packages need packages in "JEG Text Tools"

 modified by  rev reason
 -------- --- --- -----------
 3/13/97  JEG 1.0 original
 8/2/98   JEG 2.0 added Image Statistics
                  revised contact info
###################################################################

###################################################################
 FILE: "JEG Color Legend"
                                   created: 9/26/96 {6:23:37 PM} 
                               last update: 3/13/97 {2:17:07 PM} 

 Description: 
	Appends a scale bar for the data dimension of image waves
	Controls at the top of the graph allow live adjustment of
	data range and color table
	
	As of version 2.0, uses a particular interpretation of data dimension
	scaling. Specifically, if the wave is of integral type, then
	the data dimension max and min are taken to correspond to the full
	range of the appropriate integer size, e.g., an 8 bit unsigned integer
	wave with data dimension full scale of 016 nm would scale each data 
	unit to 0.0625 nm and a value of 256 would correspond to 16 nm.
	
	As of version 3.0, allows offsetting upper or lower threshold to zero.
	Preferences panel allows user customization of layout.
	No longer assumes the image is displayed left vs. bottom.
	Supports traces which are displayed with a color as f(z) of another wave.
	Renamed from "JEG Z-Legend"
	Properly determines bounds of complex waves

 History

 modified by   rev  reason
 -------- --- ----- -----------
 09/26/96 JEG 1.0.0 original
 12/15/96 JEG 2.0.0 Color index waves & integral wave scaling
 3/2/97   JEG 3.0.0 Zero offset, preferences panel, & f(z) traces
 12/7/97  JEG 3.0.1 fixed bug in horizontal legends & swapXY 
                    more robust panels
 12/14/97 JEG 3.0.2 fixed bug in Graph->Remove->Color legend
 12/14/97 JEG 3.0.3 fixed fatal bug in JEG_EnsureColorLegendPrefs()
 12/15/97 JEG 3.0.4 further fixes to Graph->Remove->Color legend,
                    fixed unmatched Set/GetDataFolder,
                    added JEG_RefreshColorLegendLinks()
 
 Needs:
   "JEG Extract Dimensions" version >= 1.1
   "JEG Keyword-Value"
	<NumInList>
	<strings as lists>
	<StrMatchList>

###################################################################
 FILE: "JEG Image Statistics"
                                   created: 8/1/98 {4:19:18 PM} 
                               last update: 8/2/98 {12:09:35 PM} 
     
 These routines add a "Roughness" item to the Analysis menu. 
 Selection of this item, allows the user to select an image from 
 the topmost graph [this needs to be more robust]. A panel is 
 then displayed which shows several commonly cited (and virtually 
 meaningless) statistics for surface morphologies, such as calculated 
 by the NanoScope software. If a Marquee is drawn out in the image, 
 the statistics panel will be automatically updated to reflect the 
 values for the region within the marquee. Removing the Marquee does not
 trigger an update (I have no control over this), but you can click
 the "Full Image" button, in this event. If the Marquee lies outside the
 image, the statistics calculated will be for the nearest edge.
 
 The statistical values are displayed with the data dimension units 
 of the image wave, if available. Moreover, if the wave is of integer 
 type, these routines will attempt to apply the integer scaling 
 described in JEG Color Legend. 
 
 Because Igor's string formatting routines rigorously apply SI prefixes 
 (I guess, now that I work for NIST, I should praise them for this), 
 rather than "1.000 " or "0.100 nm", the panel will display "100.0 pm". 
 Igor has no way of knowing that most humans don't use picometers.
 
 Note: If the data dimension units are changed after the statistics
 panel is displayed, the change will not be reflected in the panel. 
 Simply create a new statistics panel.

 I'd be happy to add other statistical measures, if requested. For 
 instance, it should be trivial to add NanoScope's Rmax if anybody can 
 explain to me what on earth "This is the difference in height between
 the highest and lowest points on the surface relative to the Mean Plane" 
 means. How can a difference be relative to anything?

 modified by  rev reason
 -------- --- --- -----------
 8/1/98   JEG 1.0 original
 
Needs:
	<Strings as Lists>
	<Keyword-Value>

###################################################################
 FILE: "JEG Scale-Bar"
                                   created: 3/3/97 {12:32:15 PM} 
                               last update: 8/11/97 {11:25:18 PM}  
         
 Appends a scale bar to an image in the current graph
 (works for traces, too). Scale bar configuration is
 entirely configurable with the "Misc->Scale-bar preferences"
 panel.
 
 Needs:
   "JEG Keyword-Value"
 
###################################################################
 FILE: "JEG Spectral Filter"
                                   created: 3/7/97 {10:27:35 PM} 
                               last update: 3/13/97 {2:06:15 PM} 
         
 Routines for graphically performing spectral image filtering
 Based on WaveMetrics' ImageMagPhase package
 
 To activate, select Graph->"Apply Spectral Filter"
 Options are given to work on a copy of the image and to retain an "undo"
 matrix to allow backing up one step. Opting not to do either saves a 
 tremendous amount of memory, but you're obviously climbing without a rope.
 
 Drag a marquee in the "Spectral Filter" window and then select "JEG_PassFilter"
 or "JEG_StopFilter" from the marquee menu. The Spectral Filter's magnitude and
 the working image will be automatically updated to reflect the change.
 Select "JEG_UndoLastFilter" from the marquee menu (drag a new marquee, if necessary)
 to return to the last step (assuming you opted to keep an "undo" matrix).
 
 "JEG Zoom Image" may prove useful in conjunction with this package
         
 modified by  rev reason
 -------- --- --- -----------
 3/7/97   JEG 1.0 original
 
 Needs:
   "JEG Keyword-Value"
   "JEG Color Legend" version >= 3.0
   <Autosize Images>
   <Strings as Lists>
   
###################################################################
 FILE: "JEG Zoom Graph"
                                   created: 3/8/97 {3:23:17 AM} 
                               last update: 3/13/97 {2:19:58 PM} 
         
 When multiple image frames are present (multiple pairs of axes),
 the Expand and Shrink marquee routines don't work properly;
 they scale all waves that fall between any bounds, not just the
 ones that fall within the marquee. These routines correct this
 discrepancy.

 modified by  rev reason
 -------- --- --- -----------
 3/8/97   JEG 1.0 original
 
###################################################################
